AddPicture(Byte[],Double,Double,Double,Double) Method

Adds the specified picture to the shapes collection at the specified position and with the specified size.

[Visual Basic]
Overloads Overridable Function AddPicture( _
   ByVal pictureData() As Byte, _
   ByVal left As Double, _
   ByVal top As Double, _
   ByVal width As Double, _
   ByVal height As Double _
) As IShape

[C#]
virtual IShape AddPicture( 
   byte[] pictureData,
   double left,
   double top,
   double width,
   double height
);

[C++]
virtual IShape* AddPicture( 
   byte[]* pictureData,
   double left,
   double top,
   double width,
   double height
) 

[C++/CLI]
virtual IShape^ AddPicture( 
   bytearray<pictureData>^ pictureData,
   double left,
   double top,
   double width,
   double height
) 

Parameters

pictureData

A byte array containing the picture data; this byte array must not be changed after calling AddPicture.

left

Left edge of the new picture in points.

top

Top edge of the new picture in points.

width

Width of the new picture in points.

height

Height of the new picture in points.

Return Type

A shape object representing the newly created picture.

Remarks

Use RowToPoints and ColumnToPoints to convert row and column positions to points.

Pictures with PNG, JPEG and Enhanced Windows Metafiles magic signatures are stored in the workbook as is. All other images are converted to PNG before being stored in the workbook.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also

IShapes Interface  | IShapes Members  | Overload List  | RowToPoints Method  | ColumnToPoints Method

See our live Excel Reporting, Excel Charting, Excel to DataGrid and Excel Calculation Samples.

Copyright © 2003-2007 SpreadsheetGear LLC. All Rights Reserved.

SpreadsheetGear and Spreadsheet Gear are trademarks of SpreadsheetGear LLC.